home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_geomview.idb / usr / freeware / lib / geomview / README.z / README
Encoding:
Text File  |  1999-01-26  |  10.4 KB  |  277 lines
  1.                       Geomview/OOGL Release 1.6.1
  2.                          The Geometry Center
  3.               December 10, 1996
  4.               -----------------
  5.  
  6. CONTENTS
  7. --------
  8.  
  9.         Introduction
  10.         Installation
  11.         More about Geomview
  12.         External Modules
  13.         Auxiliary Programs
  14.         Documentation
  15.         Geomview E-mail
  16.         History
  17.         Miscellaneous
  18.         Known Bugs
  19.         Improvements/Wish list
  20.         Bug Reports and Comments
  21.  
  22.  
  23. INTRODUCTION
  24. ------------
  25.                                    
  26. This is version 1.6.1 of Geomview/OOGL.  It runs on many UNIX workstations
  27. using X/Motif, including Silicon Graphics, Sun, Linux, HP-UX, DEC Alpha,
  28. and RS/6000, using plain Xlib graphics, Open GL if available, or GL (on SGIs).
  29. A version also runs on NextStep 3.1 or later using Quick Renderman graphics.
  30.  
  31. Geomview is an interactive geometry viewing program.  OOGL, which
  32. stands for Object Oriented Graphics Library, is the library upon
  33. which Geomview is built.
  34.  
  35. NOTE: Please read the file REGISTER.  We need to know how our
  36. users are using Geomview so that we can better serve you.
  37.  
  38. In addition, if you use geomview please send an email note to
  39. geomview-users-request@geom.umn.edu requesting to be added to the
  40. geomview-users mailing list; this list is for announcements
  41. regarding geomview and for geomview users to communicate with
  42. each other.  See the details in the GEOMVIEW E-MAIL section
  43. below.
  44.  
  45.  
  46. INSTALLATION
  47. ------------
  48.  
  49. See the INSTALL-BINARY file for installation details.  Disk space required:
  50.     geomview-hpux.tar.Z, untarred              23 MB
  51.     geomview-linux.tar.Z, untarred              22 MB
  52.     geomview-sgi.tar.Z, untarred              23 MB
  53.     geomview-solaris.tar.Z, untarred              21 MB
  54.  
  55.     geomview-src.tar.Z, assuming you've installed XForms and Tcl/Tk
  56.     "Compiled for" values are peak sizes, after "make install"
  57.         and before "make clean", and compiling with -O and not -g.
  58.     source only, untarred                  15 MB
  59.     source, compiled for SGI              72 MB
  60.     source, compiled for Sun (Solaris Sparc)      51 MB
  61.     source, compiled for Linux 'x86              49 MB
  62.     source, compiled for HP-UX              53 MB
  63.  
  64. MORE ABOUT GEOMVIEW
  65. -------------------
  66.  
  67. Geomview represents the current state of an ongoing effort at the
  68. Geometry Center to provide interactive geometry software which is
  69. particularly appropriate for mathematics research and education.
  70. In particular, geomview can display things in hyperbolic and
  71. spherical space as well as Euclidean space.
  72.  
  73. Geomview allows multiple independently controllable objects and
  74. cameras.  It provides interactive control for motion, appearances
  75. (including lighting, shading, and materials), picking on an
  76. object, edge or vertex level, snapshots in SGI image file or
  77. Renderman RIB format, and adding or deleting objects is provided
  78. through direct mouse manipulation, control panels, and keyboard
  79. shortcuts.  External programs can drive desired aspects of the
  80. viewer (such as continually loading changing geometry or
  81. controlling the motion of certain objects) while allowing
  82. interactive control of everything else.
  83.  
  84. Geomview supports the following simple data types: polyhedra with
  85. shared vertices (.off), quadrilaterals, rectangular meshes,
  86. vectors, and Bezier surface patches of arbitrary degree including
  87. rational patches.  Object hierarchies can be constructed with
  88. lists of objects and instances of object(s) transformed by one or
  89. many 4x4 matrices.  Arbitrary portions of changing hierarchies
  90. may be transmitted by creating named references.
  91.  
  92. Geomview can display Mathematica and Maple 3-D graphics output; for
  93. information on this see the files OOGL.m.doc and gvplot.doc, respectively,
  94. in the "doc" subdirectory.
  95.  
  96.  
  97. EXTERNAL MODULES
  98. ----------------
  99.  
  100. Geomview comes with several "external modules" --- programs that
  101. communicate with geomview through a command language.  The list
  102. of currently installed modules appears in the "Modules" browser
  103. on geomview's main panel.  To invoke a module, click the mouse on
  104. the appropriate line in this browser.  The modules in this
  105. distribution are:
  106.  
  107. MODULE       PLATFORMS    DESCRIPTION
  108.  
  109. addbbox:    SNX    create a wireframe box around an object
  110. animate:    SNX    flip through a sequence of objects
  111. clipboard:    SX    cut, copy and paste geometric objects
  112. cplxview:    SX    complex-function viewer, using geomview N-D projection
  113. crayola:    SNX    interactively color objects
  114. drawbdy:    SNX    compute and draw the boundary of an object
  115. example:    SX    generic FORMS example external module
  116. flythrough:    SX    interactive version of "Not Knot" hyperbolic flythrough
  117. ginsu:        SX    interactively slice objects (see "clip")
  118. graffiti:    SNX    draw line segments on objects
  119. gvclock:    SNX    3D clock, demonstrates real-time motion
  120. hinge:        SX    hinge copies of a polyhedron around its edges
  121. labeler:    X    turn text into geometric objects
  122. maniview:    SX    3-manifold viewer
  123. NDview:        SX    N-dimensional viewing controls
  124. NDdemo:        SX    N-dimensional viewing demonstration
  125. nose:        SNX    demonstrates picking
  126. stereo:        SX    hardware, crosseyed, red/cyan stereo
  127. sweep:        SN    generate objects of rotation from line segments
  128. tackdown:    SX    redefine an object's "home" position
  129. transformer:    SX    explicitly control an object's transformation matrix
  130. trigrp:        S    explore triangle symmetry groups
  131.  
  132. (S means SGI version exists, N means NeXTStep version exists,
  133. X means X version exists.)
  134.  
  135.                                     
  136. AUXILIARY PROGRAMS
  137. ------------------
  138.  
  139. PROGRAM        PLATFORMS    DESCRIPTION
  140.  
  141. anytooff:    SNX    convert any OOGL object into OFF format
  142. anytoucd:    SNX    convert any OOGL object into UCD format
  143. bdy:        SNX      compute the boundary edges of a geom as a VECT file
  144. bez2mesh:    SNX    convert Bezier object to MESH
  145. clip:        SNX    clip OOGL objects against planes or other surfaces
  146. hvectext:    SNX    produce VECT text from Ghostscript Hershey fonts
  147. math2oogl:    SNX    convert Mathematica graphics object to OOGL format
  148. offconsol:    SNX      consolidate duplicate vertices in an OFF file
  149. oogl2rib    SNX    convert OOGL to RenderMan RIB (see OOGL.m.doc)
  150. polymerge:    SNX    merge vertices, edges, and faces in an OFF file
  151. togeomview:    SNX    pipe GCL commands or geometry to a copy of geomview,
  152.                   invoking geomview if necessary
  153. ucdtooff:    SNX    convert UCD format file into an OFF OOGL file
  154.  
  155. (S means SGI version exists, N means NeXTStep version exists,
  156. X means X version exists)
  157.  
  158.  
  159. DOCUMENTATION
  160. -------------
  161.  
  162. A comprehensive manual is in the "doc" subdirectory.  This manual
  163. was written specifically for the SGI version.  Most, but not all
  164. of it, applies to the NeXT and X11 version as well.  There is
  165. also a copy of this manual on the World Wide Web at URL:
  166. http://www.geom.umn.edu/docs/software/geomview/geomview_toc.html.
  167.  
  168. The file doc/oogltour gives an introduction to the OOGL file
  169. format, which is the format of geometry files that geomview
  170. reads.  More details are in the manual.
  171.  
  172. Further documentation is in the "man" directory, which contains
  173. Unix manual pages in both nroff source and formatted form.  Each
  174. external module, as well as geomview itself, has a manual
  175. page.  Of particular interest are:
  176.  
  177.     man/cat1/geomview.1    geomview man page
  178.     man/cat5/geomview.5    geomview command language reference
  179.     man/cat5/oogl.5        OOGL file format reference
  180.     doc/OOGL.m.doc        documentation for interface to Mathematica
  181.     doc/gvplot.doc        documentation for interface to Maple
  182.  
  183.  
  184. GEOMVIEW E-MAIL
  185. ---------------
  186.  
  187. There are three electronic mail addresses for communication
  188. regarding geomview:
  189.  
  190. geomview-users@geom.umn.edu:
  191.  
  192.     This is a mailing list of people using geomview and can be used
  193.     for communication between users regarding geomview problems,
  194.     questions, experiences, etc.  The geomview authors are also a part
  195.     of this list and will respond to questions posted to it.  We also
  196.     use this list to make announcements about new releases and other
  197.     things of interest to users.  To be added to or removed from the
  198.     geomview-users list, send a note to geomview-users-request@geom.umn.edu
  199.  
  200. software@geom.umn.edu:
  201.  
  202.     This is the "official" support line; it reaches the geomview
  203.     authors directly.  In general if you have a question or comment
  204.     that may be of interest to other users, send it to the
  205.     "geomview-users" address.  Use "software" for communication
  206.     intended just for the authors; in particular, send bug reports and
  207.     suggestions for improvement to this address.
  208.  
  209. register@geom.umn.edu
  210.  
  211.     Use this address to tell us what you are doing with Geomview.  The
  212.     Geometry Center is funded by the National Science Foundation, and
  213.     it is important that we be able to report to NSF the ways in which
  214.     our software is being used.  If you use Geomview in your work
  215.     please send us a note at this address telling us what you are
  216.     doing with it.  See the file REGISTER for more details.  Please do
  217.     not send bug reports or questions to this address; use
  218.     "software@geom.umn.edu" for that.
  219.  
  220.  
  221. HISTORY
  222. -------
  223.  
  224. This project began in the summer of 1988 with the work of Pat
  225. Hanrahan on a viewing program called MinneView.  Shortly
  226. thereafter Charlie Gunn begin developing OOGL in conjunction with
  227. MinneView.  In the time since then, many people have contributed,
  228. including Stuart Levy, Mark Meuer, Tamara Munzner, Steve
  229. Anderson, Mario Lopez, Todd Kaplan.
  230.  
  231. In 1991, OOGL was rewritten and a new viewer geomview was begun.
  232. Both geomview and the new OOGL have a core of device-independent
  233. common code.  Currently there are device drivers for SGI GL,
  234. PhotoRealistic RenderMan, Quick RenderMan on the NeXT, and the X
  235. Window System.  The NeXT version of geomview was written by
  236. Daniel Krech and Scott Wisdom.  Scott Wisdom wrote the Photo
  237. Realistic and Quick RenderMan OOGL drivers.  The SGI version of
  238. geomview and OOGL was written by Stuart Levy, Tamara Munzner, and
  239. Mark Phillips.  The geomview common kernel was written by Stuart
  240. Levy, Tamara Munzner, and Mark Phillips, with contributions from
  241. Nathaniel Thurston and Celeste Fowler.  The X version was created
  242. by Daeron Meyer and Timothy Rowley.
  243.  
  244.  
  245. MISCELLANEOUS
  246. -------------
  247.  
  248. For a list of changes between versions, see the file CHANGES.
  249.  
  250. Geomview is copyrighted software.  Please read the file COPYING
  251. in this directory before using or distributing Geomview.
  252.     
  253. The file MANIFEST contains a list of the files in this
  254. distribution.
  255.  
  256.  
  257. KNOWN BUGS
  258. ----------
  259.  
  260. (S refers to a SGI bug, N refers to a NeXTStep bug, and X refers
  261. to a X bug)
  262.  
  263. Picking can fail if any part of any object is behind the camera plane. (SNX)
  264.  
  265. IMPROVEMENTS AND WISH LIST
  266. ==========================
  267.  
  268. Text should come soon.  Meanwhile, you can use Labeler or hvectext,
  269. and the INST "origin" and "location" features to paste it on the screen.
  270.  
  271.  
  272. BUG REPORTS AND COMMENTS
  273. ------------------------
  274.  
  275. Please send bug reports and comments about this version to
  276. software@geom.umn.edu.
  277.